DRT_BOOTSTRAP_PROVIDER結構 (drt.h)
DRT_BOOTSTRAP_PROVIDER結構會定義必須由啟動程式提供者實作的 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_PROVIDER的pvCoNtext值。
Detach
使用一組 DRT 遞減啟動程式提供者的參考計數。
pvCoNtext
包含來自 DRT_BOOTSTRAP_PROVIDER的pvCoNtext值。
InitResolve
由 DRT 基礎結構呼叫,以提供即將推出的名稱解析的設定資訊。
pvCoNtext
包含來自 DRT_BOOTSTRAP_PROVIDER的pvCoNtext值。
fSplitDetect
指定解析作業是否正用於網路分割偵測和復原。
timeout
指定解析在逾時之前應該花費的時間上限。此值以毫碼錶示。
cMaxResults
指定要在解析作業期間傳回的結果數目上限。
ResolveCoNtext
解析程式特定資料的指標。
fFatalError
如果啟動程式提供者遇到無法復原的錯誤,當函式完成時,此參數必須設定為 TRUE ,DRT 才能轉換為錯誤狀態。 可供較高層應用程式進行偵錯的HRESULT會出現在與事件相關聯的DRT_EVENT_DATA結構hr成員中,指出轉換至錯誤狀態的事件。 如果 將 fFatalError 旗標設定為 TRUE,則此啟動程式提供者函式不應該傳回S_OK。
IssueResolve
由 DRT 基礎結構呼叫以發出解決方案,以判斷 DRT 雲端中已作用中的節點端點。
pvCoNtext
包含來自 DRT_BOOTSTRAP_PROVIDER的pvCoNtext值。
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_PROVIDER的pvCoNtext值。
ResolveCoNtext
從指定啟動程式提供者的 Resolve 函式收到的 BOOTSTRAP_RESOLVE_CONTEXT 。
Register
使用啟動載入機制註冊端點。 此程式可讓其他節點透過啟動程式解析程式尋找端點。
pvCoNtext
包含來自 DRT_BOOTSTRAP_PROVIDER的pvCoNtext值。
pAddressList
要向啟動載入機制註冊之地址清單的指標。
Unregister
此函式會取消註冊具有啟動載入機制的端點。 因此,其他節點將無法透過啟動程式解析程式找到本機節點。
pvCoNtext
包含來自 DRT_BOOTSTRAP_PROVIDER的pvCoNtext值。
需求
最低支援的用戶端 | Windows 7 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
標頭 | drt.h |