[某些資訊與發行前的產品有關，在正式發行前可能會大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。
VmbConvertVmbusHandleToKernelHandle 函式會將使用者模式 VMBus 句柄轉換為核心模式句柄。
語法
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;
NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
HANDLE VmbusHandle,
PHANDLE KernelHandle
)
{...}
參數
VmbusHandle
要轉換的使用者模式句柄。 這必須在虛擬機背景工作進程中開啟。
KernelHandle
參考與 VmbusHandle 值相同的物件的核心句柄。
傳回值
如果作業成功，則傳回STATUS_SUCCESS，否則傳回適當的NTSTATUS錯誤碼。
言論
呼叫端負責關閉核心句柄。
因為 VmbusHandle 參數是使用者模式句柄，因此必須在開啟 VMBus 句柄的使用者模式進程內容中呼叫此函式。
呼叫此函式通常緊接著呼叫 VmbServerChannelInitSetVmbusHandle 函式。
重要
此函式是透過 Vmbkmcl.sys 總線驅動程式提供的 VMBus 核心模式用戶端連結庫 （KMCL） 介面來呼叫。 這是從 KMCL_SERVER_ONLY_METHODS 結構存取的伺服器專用函式。
如需詳細資訊，請參閱 KMCL_SERVER_ONLY_METHODS的一節。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1803 |
| 標頭 | vmbuskernelmodeclientlibapi.h |