共用方式為


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

啟動程式解析程式所定義之內容資料的指標。 建立啟動程式解析程式時,需要開發人員以必要的資訊填入解析程式;通常,這會以「這個」指標的形式發生。 此內容會傳遞至 DRT_BOOTSTRAP_PROVIDER所定義之函式中的所有內容參數。

Attach

使用一組 DRT 遞增啟動程式提供者的參考計數。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

Detach

使用一組 DRT 遞減啟動程式提供者的參考計數。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

InitResolve

由 DRT 基礎結構呼叫,以提供即將推出的名稱解析的設定資訊。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

fSplitDetect

指定解析作業是否正用於網路分割偵測和復原。

timeout

指定解析在逾時之前應該花費的時間上限。此值以毫碼錶示。

cMaxResults

指定要在解析作業期間傳回的結果數目上限。

ResolveCoNtext

解析程式特定資料的指標。

fFatalError

如果啟動程式提供者遇到無法復原的錯誤,當函式完成時,此參數必須設定為 TRUE ,DRT 才能轉換為錯誤狀態。 可供較高層應用程式進行偵錯的HRESULT會出現在與事件相關聯的DRT_EVENT_DATA結構hr成員中,指出轉換至錯誤狀態的事件。 如果 將 fFatalError 旗標設定為 TRUE,則此啟動程式提供者函式不應該傳回S_OK。

IssueResolve

由 DRT 基礎結構呼叫以發出解決方案,以判斷 DRT 雲端中已作用中的節點端點。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

pvCallbackCoNtext

傳回下一個參數所定義回呼之內容資料的指標。

回撥

針對每個結果和DRT_E_NO_MORE回呼叫的BOOTSTRAP_RESOLVE_CALLBACK。

ResolveCoNtext

解析程式特定資料的指標。

fFatalError

如果啟動程式提供者遇到無法復原的錯誤,當函式完成時,此參數必須設定為 TRUE ,DRT 才能轉換為錯誤狀態。 可供較高層應用程式進行偵錯的HRESULT會出現在與事件相關聯的DRT_EVENT_DATA結構hr成員中,指出轉換至錯誤狀態的事件。 如果 將 fFatalError 旗標設定為 TRUE,則此啟動程式提供者函式不應該傳回S_OK。

EndResolve

結束端點的解析。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

ResolveCoNtext

從指定啟動程式提供者的 Resolve 函式收到的 BOOTSTRAP_RESOLVE_CONTEXT

Register

使用啟動載入機制註冊端點。 此程式可讓其他節點透過啟動程式解析程式尋找端點。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

pAddressList

要向啟動載入機制註冊之地址清單的指標。

Unregister

此函式會取消註冊具有啟動載入機制的端點。 因此,其他節點將無法透過啟動程式解析程式找到本機節點。

pvCoNtext

包含來自 DRT_BOOTSTRAP_PROVIDERpvCoNtext值。

需求

   
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 drt.h