TLSKeyPackEnumBegin 函式
根據搜尋準則,開始列舉安裝在遠端桌面授權伺服器上的所有金鑰套件。
注意
此函式沒有相關聯的標頭檔或匯入程式庫。 若要呼叫此函式,您必須建立使用者定義的標頭檔,並使用 LoadLibrary 和 GetProcAddress 函式動態連結至Mstlsapi.dll。
語法
DWORD WINAPI TLSKeyPackEnumBegin(
_In_ TLS_HANDLE hHandle,
_In_ DWORD dwSearchParm,
_In_ BOOL bMatchAll,
_In_ LSKeyPack *lpSearchParm,
_Out_ PDWORD pdwErrCode
);
參數
-
hHandle [in]
-
遠端桌面授權伺服器的控制碼。 指定 TLSConnectToLsServer 函式所開啟的控制碼。
-
dwSearchParm [in]
-
指定搜尋準則。 此參數保留供日後使用,且必須包含0xFFFFFFFF。
-
bMatchAll [in]
-
指定是否要符合所有搜尋值。
-
lpSearchParm [in]
-
LSKeyPack結構的指標,指定要尋找的搜尋參數。
-
pdwErrCode [out]
-
傳回時收到下列其中一個錯誤碼的變數指標。
-
LSERVER_S_SUCCESS (0)
-
呼叫成功。
-
LSERVER_E_INTERNAL_ERROR (5001)
-
授權伺服器的內部錯誤。
-
LSERVER_E_INVALID_SEQUENCE (5006)
-
呼叫序列無效。 最有可能是先前的列舉尚未結束。
-
LSERVER_E_SERVER_BUSY (5007)
-
授權伺服器太忙碌,無法處理要求。
-
LSERVER_E_OUTOFMEMORY (5008)
-
因為記憶體不足,所以無法處理要求。
-
LSERVER_E_INVALID_DATA (5009)
-
搜尋參數中的資料無效。
傳回值
此函式會傳回下列可能的傳回值。
-
RPC_S_OK
-
呼叫成功。 檢查 pdwErrCode 參數的值,以取得呼叫的傳回碼。
-
RPC_S_INVALID_ARG
-
引數無效。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
DLL |
|