函式原型,參數,Name[in],Flags[in],返回值,備註,需求,
創建邊界描述符
函式原型
HANDLE WINAPI CreateBoundaryDescriptor(
__in LPCTSTR Name,
__in ULONG Flags
);
參數
Name[in]
邊界描述符的名稱。
Flags[in]
這個參數是為以後保留的。目前沒什麼用,可以為之傳入0。
返回值
如果函式成功,則函式返回創建成功的邊界描述符的句柄。如果函式失敗,則返回NULL。如果想要知道額外的錯誤信息,可以調用GetLastError函式查看。
備註
一個新的邊界描述符必須至少有一個安全標識符(SID),可以用AddSIDToBoundaryDescriptor函式為這個邊界描述符直接一個SID。想要編譯應用程式時使用AddSIDToBoundaryDescriptor函式,需要定義 _WIN32_WINNT不低於0x0600。
函式的簽名暗示返回值是一個核心對象句柄,但實情並非如此。返回值是一個指針,它指向一個用戶模式的結構,結構中包含了邊界的定義。由於這個原因,永遠都不要把返回的句柄值傳給CloseHandle;相反,應該把它傳給DeleteBoundaryDescriptor。
需求
系統最低要求 | Windows Vista |
伺服器支持的最低要求 | Windows Server 2008 |
頭檔案 | Winbase.h (include Windows.h) |
靜態庫 | Kernel32.lib |
動態庫 | Kernel32.dll |
Unicode和ANSI函式名 | CreateBoundaryDescriptorW (Unicode) CreateBoundaryDescriptorA (ANSI) |