다음을 통해 공유


TLSLicenseEnumBegin 함수

검색 조건에 따라 원격 데스크톱 라이선스 서버에서 발급한 라이선스의 열거를 시작합니다.

참고

이 함수에는 연결된 헤더 파일 또는 가져오기 라이브러리가 없습니다. 이 함수를 호출하려면 사용자 정의 헤더 파일을 만들고 LoadLibraryGetProcAddress 함수를 사용하여 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
Mstlsapi.dll

추가 정보

LSLicense

TLSConnectToLsServer

TLSLicenseEnumNext

TLSLicenseEnumEnd