TLSLicenseEnumBegin 函式
根據搜尋準則，開始列舉遠端桌面授權伺服器所發出的授權。
注意
此函式沒有相關聯的標頭檔或匯入程式庫。 若要呼叫此函式，您必須建立使用者定義的標頭檔，並使用 LoadLibrary 和 GetProcAddress 函式動態連結至Mstlsapi.dll。
語法
DWORD WINAPI TLSLicenseEnumBegin(
_In_ TLS_HANDLE hHandle,
_In_ DWORD dwSearchParm,
_In_ BOOL bMatchAll,
_In_ LSLicense *lpSearchParm,
_Out_ PDWORD pdwErrCode
);
參數
-
hHandle [in]
-
遠端桌面授權伺服器的控制碼。 指定 TLSConnectToLsServer 函式所開啟的控制碼。
-
dwSearchParm [in]
-
指定搜尋準則。 參數可以是下列清單中所述的值之一或組合。 參數會指定要搜尋的金鑰套件類型，以及要搜尋的金鑰套件類型。
-
LSLICENSE_SEARCH_LICENSEID (0x00000001)
-
依授權識別碼搜尋。
-
LSLICENSE_SEARCH_KEYPACKID (0x00000002)
-
依金鑰套件識別碼搜尋。
-
LSLICENSE_SEARCH_MACHINENAME (0x00000008)
-
依電腦名稱稱搜尋。
-
LSLICENSE_SEARCH_USERNAME (0x00000010)
-
依使用者名稱搜尋。
-
LSLICENSE_SEARCH_ISSUEDATE (0x00000080)
-
依發行日期搜尋。
-
LSLICENSE_SEARCH_EXPIREDATE (0x00000100)
-
依到期日搜尋。
-
LSLICENSE_SEARCH_ NUMLICENSES (0x00000200)
-
依授權數目搜尋。
-
LSLICENSE_SEARCH_ ENTRY_STATUS (0x20000000)
-
依專案狀態搜尋。
-
LSLICENSE_EXSEARCH_LICENSESTATUS (0x00100000)
-
依授權狀態搜尋。
-
LSKEYPACK_SEARCH_ALL (0xFFFFFFFF)
-
搜尋所有授權。
bMatchAll [in]
指定是否要符合所有搜尋值。
lpSearchParm [in]
LSLicense結構的指標，指定要尋找的搜尋參數。
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 |
|