CredUnprotectA 함수(wincred.h)

CredUnprotect 함수는 CredProtect 함수를 사용하여 이전에 암호화된 자격 증명의 암호를 해독합니다. 자격 증명은 CredUnprotect 가 호출되는 것과 동일한 보안 컨텍스트에서 암호화되어야 합니다.

구문

BOOL CredUnprotectA(
  [in]      BOOL  fAsSelf,
  [in]      LPSTR pszProtectedCredentials,
  [in]      DWORD cchProtectedCredentials,
  [out]     LPSTR pszCredentials,
  [in, out] DWORD *pcchMaxChars
);

매개 변수

[in] fAsSelf

TRUE로 설정하여 자격 증명이 현재 프로세스의 보안 컨텍스트에서 암호화되도록 지정합니다. 호출 스레드 보안 컨텍스트의 보안 컨텍스트에서 자격 증명이 암호화되도록 지정하려면 FALSE 로 설정합니다.

[in] pszProtectedCredentials

암호화된 자격 증명을 지정하는 문자열에 대한 포인터입니다.

[in] cchProtectedCredentials

pszProtectedCredentials 버퍼의 크기(문자)입니다.

[out] pszCredentials

출력 시 암호 해독된 자격 증명을 수신하는 문자열에 대한 포인터입니다.

[in, out] pcchMaxChars

pszCredentials 버퍼의 문자로 된 크기입니다. 출력에서 pszCredentials 가 암호화된 자격 증명을 받기에 충분한 크기가 아닌 경우 이 매개 변수는 pszCredentials 버퍼의 필요한 크기(문자)를 지정합니다.

반환 값

함수가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

확장된 오류 정보는 GetLastError 함수를 호출합니다. 다음 표에서는 GetLastError 함수에 대한 일반적인 값을 보여 있습니다.

반환 코드/값	설명
ERROR_NOT_CAPABLE	자격 증명을 암호화하는 데 사용되는 보안 컨텍스트는 자격 증명의 암호를 해독하는 데 사용되는 보안 컨텍스트와 다릅니다.
ERROR_INSUFFICIENT_BUFFER	pszCredentials 버퍼의 크기가 부족했습니다.

설명

참고

wincred.h 헤더는 CRedUnprotect를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wincred.h
라이브러리	Advapi32.lib
DLL	Advapi32.dll