структура DRT_BOOTSTRAP_PROVIDER (drt.h)

  • Статья

Структура DRT_BOOTSTRAP_PROVIDER определяет интерфейс DRT, который должен быть реализован поставщиком начальной загрузки.

Примечание Инфраструктура DRT не вызывает методы поставщика начальной загрузки одновременно.
 

Синтаксис

typedef struct drt_bootstrap_provider_tag {
  PVOID    pvContext;
  HRESULT( )(const PVOID pvContext) *Attach;
  VOID( )(const PVOID pvContext)    *Detach;
  HRESULT((const PVOID pvContext,BOOL fSplitDetect,ULONG timeout,ULONG cMaxResults,DRT_BOOTSTRAP_RESOLVE_CONTEXT *ResolveContext,BOOL *fFatalError) * )InitResolve;
  HRESULT()(const PVOID pvContext, const PVOID pvCallbackContext,DRT_BOOTSTRAP_RESOLVE_CALLBACK callback,DRT_BOOTSTRAP_RESOLVE_CONTEXT ResolveContext,BOOL *fFatalError) * IssueResolve;
  VOID( )(const PVOID pvContext,DRT_BOOTSTRAP_RESOLVE_CONTEXT ResolveContext)    *EndResolve;
  HRESULT()(const PVOID pvContext, const SOCKET_ADDRESS_LIST *pAddressList) * Register;
  VOID( )(const PVOID pvContext)    *Unregister;
} DRT_BOOTSTRAP_PROVIDER, *PDRT_BOOTSTRAP_PROVIDER;

Члены

pvContext

Указатель на контекстные данные, определенные сопоставителем начальной загрузки. При создании сопоставителя начальной загрузки разработчик должен заполнить сопоставитель необходимыми сведениями; часто это происходит в виде указателя "this". Этот контекст передается всем параметрам контекста в функциях, определенных DRT_BOOTSTRAP_PROVIDER.

Attach

Увеличивает количество ссылок для поставщика начальной загрузки с помощью набора DRT.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

Detach

Уменьшает количество ссылок для поставщика начальной загрузки с помощью набора DRT.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

InitResolve

Вызывается инфраструктурой DRT для предоставления сведений о конфигурации о предстоящих разрешениях имен.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

fSplitDetect

Указывает, используется ли операция разрешения для обнаружения и восстановления разделения сети.

timeout

Указывает максимальное время, которое должно занять разрешение до истечения времени ожидания. Это значение представлено в миллисекундах.

cMaxResults

Указывает максимальное количество результатов, возвращаемых во время операции разрешения.

ResolveContext

Указатель на данные, относящиеся к сопоставителям.

fFatalError

Если поставщик начальной загрузки обнаруживает неустранимую ошибку, этот параметр должен иметь значение TRUE после завершения функции, чтобы DRT переключился в состояние сбоя. HRESULT, который предоставляется приложению более высокого уровня для отладки, будет отображаться в элементе hrструктуры DRT_EVENT_DATA, связанной с событием, сигналивющим о переходе в состояние сбоя. Эта функция поставщика начальной загрузки не должна возвращать S_OK, если для флага fFatalError задано значение TRUE.

IssueResolve

Вызывается инфраструктурой DRT для выдачи разрешения для определения конечных точек узлов, уже активных в облаке DRT.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

pvCallbackContext

Указатель на данные контекста, которые передаются обратно в обратный вызов, определенный в следующем параметре.

обратный вызов

BOOTSTRAP_RESOLVE_CALLBACK, вызываемая для каждого результата и DRT_E_NO_MORE.

ResolveContext

Указатель на данные, относящиеся к сопоставителям.

fFatalError

Если поставщик начальной загрузки обнаруживает неустранимую ошибку, этот параметр должен иметь значение TRUE после завершения функции, чтобы DRT переключился в состояние сбоя. HRESULT, который предоставляется приложению более высокого уровня для отладки, будет отображаться в элементе hrструктуры DRT_EVENT_DATA, связанной с событием, сигналивющим о переходе в состояние сбоя. Эта функция поставщика начальной загрузки не должна возвращать S_OK, если для флага fFatalError задано значение TRUE.

EndResolve

Завершает разрешение конечной точки.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

ResolveContext

BOOTSTRAP_RESOLVE_CONTEXT получен от функции Resolve указанного поставщика начальной загрузки.

Register

Регистрирует конечную точку с помощью механизма начальной загрузки. Этот процесс позволяет другим узлам найти конечную точку с помощью сопоставителя начальной загрузки.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

pAddressList

Указатель на список адресов для регистрации с помощью механизма начальной загрузки.

Unregister

Эта функция отменяет регистрацию конечной точки с помощью механизма начальной загрузки. В результате другие узлы не смогут найти локальный узел через сопоставитель начальной загрузки.

pvContext

Содержит значение pvContext из DRT_BOOTSTRAP_PROVIDER.

Требования

   
Минимальная версия клиента Windows 7 Профессиональная [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Верхняя часть drt.h