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)
-
라이선스 ID로 검색합니다.
-
LSLICENSE_SEARCH_KEYPACKID (0x00000002)
-
키 팩 ID로 검색합니다.
-
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 |
|