CredGetTargetInfoA 함수(wincred.h)
CredGetTargetInfo 함수는 명명된 대상 컴퓨터에 대해 알려진 모든 대상 이름 정보를 검색합니다. 로컬로 실행되며 특정 권한이 필요하지 않습니다. 반환된 정보는 CredReadDomainCredentials 및 CredWriteDomainCredentials 함수에 전달되어야 합니다. 정보는 다른 용도로 사용해서는 안 됩니다.
인증 패키지는 TargetName에 인증을 시도할 때 TargetInfo를 컴퓨팅합니다. 인증 패키지는 이 대상 정보를 캐시하여 CredGetTargetInfo에서 사용할 수 있도록 합니다. 따라서 대상 정보는 TargetName을 인증하려는 최근 시도에서만 사용할 수 있습니다.
LSA 프로세스에 없는 인증 패키지는 CRED_CACHE_TARGET_INFORMATION 플래그를 사용하여 CredReadDomainCredentials를 호출하여 CredGetTargetInfo에서 나중에 검색할 수 있는 TargetInfo를 캐시할 수 있습니다.
구문
BOOL CredGetTargetInfoA(
[in] LPCSTR TargetName,
[in] DWORD Flags,
[out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);
매개 변수
[in] TargetName
정보를 검색할 대상 컴퓨터의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
[in] Flags
함수의 작업을 제어하는 플래그입니다. 다음 플래그를 사용할 수 있습니다.
CRED_ALLOW_NAME_RESOLUTION
TargetName 이름 확인에 대한 대상 정보를 찾을 수 없는 경우 TargetName에서 다른 양식으로 변환합니다. 이러한 다른 양식에 대한 대상 정보가 있으면 해당 정보가 반환됩니다. 현재 DNS 이름 확인만 수행됩니다.
이는 애플리케이션이 인증 패키지를 직접 호출하지 않는 경우에 유용합니다. 애플리케이션은 TargetName을 다른 소프트웨어 계층에 전달하여 서버에 인증할 수 있으며, 해당 소프트웨어 계층은 이름을 resolve 확인된 이름을 인증 패키지에 전달할 수 있습니다. 따라서 원래 TargetName에 대한 대상 정보는 없습니다.
[out] TargetInfo
대상 정보를 포함하도록 할당된 단일 블록 버퍼에 대한 포인터입니다. TargetInfo의 반환된 멤버 중 하나 이상이 NULL이 아닌 멤버가 됩니다. 버퍼 내에 포함된 모든 포인터는 이 단일 할당된 블록 내의 위치에 대한 포인터입니다. CredFree를 호출하여 반환된 단일 버퍼를 해제해야 합니다.
반환 값
함수는 성공 시 TRUE 를 반환하고 실패 시 FALSE 를 반환합니다. GetLastError 함수를 호출하여 보다 구체적인 상태 코드를 가져올 수 있습니다. 다음 상태 코드를 반환할 수 있습니다.
- ERROR_NOT_FOUND
명명된 서버에 대한 대상 정보를 사용할 수 없습니다.
설명
참고
wincred.h 헤더는 CRedGetTargetInfo를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wincred.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |