다음을 통해 공유

CredRenameA 함수(wincred.h)

  • 아티클

[CredRename 더 이상 지원되지 않습니다. Windows Vista부터 CredRename 호출 항상 ERROR_NOT_SUPPORTED 반환합니다.]

CredRename 함수는 사용자의 자격 증명 집합에 있는 자격 증명의 이름을 바꿉니다. 사용되는 자격 증명 집합은 현재 토큰의 로그온 세션과 연결된 자격 증명 집합입니다. 토큰에 사용자의 SID를 사용하지 않도록 설정해서는 안됩니다.

통사론

BOOL CredRenameA(
  [in] LPCSTR OldTargetName,
  [in] LPCSTR NewTargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

매개 변수

[in] OldTargetName

이름을 바꿀 자격 증명의 현재 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] NewTargetName

자격 증명의 새 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] Type

이름을 바꿀 자격 증명의 형식입니다. *에서 정의한 CRED_TYPE_ 중 하나여야 합니다.

[in] Flags

함수의 작업을 제어하는 플래그입니다. 현재 예약되어 있으며 0이어야 합니다.

반환 값

이 함수는 성공에 대한 TRUE 반환하고 실패시 FALSE . GetLastError 함수를 호출하여 보다 구체적인 상태 코드를 가져올 수 있습니다. 다음 상태 코드를 반환할 수 있습니다.

  • ERROR_NOT_FOUND

    지정된 OldTargetName자격 증명이 없습니다.

  • ERROR_ALREADY_EXISTS

    이미 자격 증명 또는 형식 형식 이름이 NewTargetName.

  • ERROR_NO_SUCH_LOGON_SESSION

    로그온 세션이 없거나 이 로그온 세션과 연결된 자격 증명 집합이 없습니다. 네트워크 로그온 세션에는 연결된 자격 증명 집합이 없습니다.

  • ERROR_INVALID_FLAGS

    Flags 매개 변수에 유효하지 않은 플래그가 지정되었습니다.

발언

메모

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

요구 사항

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