TLSGetServerCertificate 함수
원격 데스크톱 라이선스 서버의 인증서를 반환합니다.
참고
이 함수에는 연결된 헤더 파일 또는 가져오기 라이브러리가 없습니다. 이 함수를 호출하려면 사용자 정의 헤더 파일을 만들고 LoadLibrary 및 GetProcAddress 함수를 사용하여 Mstlsapi.dll 동적으로 연결해야 합니다.
구문
DWORD WINAPI TLSGetServerCertificate(
_In_ TLS_HANDLE hHandle,
_In_ BOOL bSignCert,
_Out_ LPBYTE *ppbCertBlob,
_Out_ LPDWORD lpdwCertBlobLen,
_Out_ PDWORD pdwErrCode
);
매개 변수
-
hHandle [in]
-
TLSConnectToLsServer 함수에 대한 호출로 열리는 원격 데스크톱 라이선스 서버에 대한 핸들입니다.
-
bSignCert [in]
-
서명 인증서인 경우 TRUE, EXCHANGE 인증서의 경우 FALSE 입니다.
-
ppbCertBlob [out]
-
인증서가 포함된 버퍼에 대한 포인터를 수신하는 변수에 대한 포인터입니다.
-
lpdwCertBlobLen [out]
-
반환되는 인증서의 크기를 받는 변수에 대한 포인터입니다.
-
pdwErrCode [out]
-
오류 코드를 수신하는 변수에 대한 포인터입니다.
-
LSERVER_S_SUCCESS (0)
-
호출이 성공했습니다.
-
TLS_W_SELFSIGN_CERTIFICATE (4007)
-
반환된 인증서는 자체 서명된 인증서입니다.
-
TLS_W_TEMP_SELFSIGN_CERT (4009)
-
반환된 인증서는 임시입니다.
-
TLS_E_ACCESS_DENIED (5003)
-
액세스가 거부되었습니다.
-
TLS_E_ALLOCATE_HANDLE (5007)
-
서버가 너무 바빠서 요청을 처리하지 않습니다.
-
TLS_E_NO_CERTIFICATE (5022)
-
인증서를 검색할 수 없습니다.
반환 값
이 함수는 다음과 같은 가능한 반환 값을 반환합니다.
-
RPC_S_OK
-
호출이 성공했습니다. pdwErrCode 매개 변수 값을 확인하여 호출에 대한 반환 코드를 가져옵니다.
-
RPC_S_INVALID_ARG
-
잘못된 인수입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| DLL |
|