dispatch_destroy()

Уничтожить структуру диспетчера

Прототип:

#include <sys/iofunc.h>
#include <sys/dispatch.h>
                                       
int dispatch_destroy( dispatch_t *dpp );

Аргументы:

dpp

Дескриптор структуры диспетчера, созданной dispatch_create().

Библиотека:

libc

Описание:

Функция dispatch_destroy() уничтожает указанную структуру диспетчера.

Эта функция является частью уровня диспетчера менеджера ресурсов.

Возвращаемое значение:

0

Успешное завершение.

-1

Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EINVAL

Дескриптор диспетчера dpp некорректен.

Примеры:

#include <sys/dispatch.h>
#include <stdio.h>        
#include <stdlib.h>       
                                       
int main( int argc, char **argv )
{
    dispatch_t  *dpp;
    int         destroyed;
                   
    if ( ( dpp = dispatch_create() ) == NULL )
    {
        fprintf( stderr, "%s: Unable to allocate dispatch handle.\n", argv[0] );
        return (EXIT_FAILURE);
    }
    ...
            
    if ( (destroyed = dispatch_destroy( dpp )) == -1 )
    {
        fprintf ( stderr, "Dispatch wasn't destroyed, bad dispatch handle %d.\n", dpp );
        return (EXIT_FAILURE);
    }
    /* else dispatch was destroyed */
    ...
                   
    return (EXIT_SUCCESS);
}

Другие примеры, использующие интерфейс диспетчера см. на страницах dispatch_create(), message_attach(), resmgr_attach() и thread_pool_create().

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

Тематические ссылки:

dispatch_create(), dispatch_create_channel()

Предыдущий раздел: Описание API системной библиотеки