CredProtectA 함수(wincred.h)

CredProtect 함수는 현재 보안 컨텍스트만 암호를 해독할 수 있도록 지정된 자격 증명을 암호화합니다.

구문

BOOL CredProtectA(
  [in]      BOOL                 fAsSelf,
  [in]      LPSTR                pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPSTR                pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

매개 변수

[in] fAsSelf

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

[in] pszCredentials

암호화할 자격 증명을 지정하는 문자열에 대한 포인터입니다. 함수는 cchCredentials 매개 변수에 제공된 문자 수를 암호화합니다.

[in] cchCredentials

pszCredentials 버퍼의 크기(문자 단위)입니다.

[out] pszProtectedCredentials

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

[in, out] pcchMaxChars

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

[out] ProtectionType

출력에서 제공된 보호 유형을 지정하는 CRED_PROTECTION_TYPE 열거형 형식에 대한 포인터입니다.

반환 값

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

확장된 오류 정보는 GetLastError 함수를 호출합니다.

설명

CredProtect 함수의 출력은 무결성으로 보호되지 않으므로 출력이 수정되면 CredUnprotect 함수가 업데이트되지 않고 잘못된 결과가 생성될 수 있습니다.

참고

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

요구 사항

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