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 TargetName 이름 확인이 수행되어 다른 양식으로 변환됩니다. 다른 양식에 대한 대상 정보가 있으면 해당 정보가 반환됩니다. 현재 DNS 이름 확인만 수행됩니다.

이는 애플리케이션이 인증 패키지를 직접 호출하지 않는 경우에 유용합니다. 애플리케이션은 TargetName 다른 소프트웨어 계층에 전달하여 서버에 인증할 수 있으며, 해당 소프트웨어 계층은 이름을 확인하고 확인된 이름을 인증 패키지에 전달할 수 있습니다. 따라서 원래 TargetName대한 대상 정보는 없습니다.

[out] TargetInfo

대상 정보를 포함하도록 할당된 단일 블록 버퍼에 대한 포인터입니다. TargetInfo 반환된 멤버 중 하나 이상이 NULL이 아닌 것입니다. 버퍼 내에 포함된 모든 포인터는 이 단일 할당된 블록 내의 위치에 대한 포인터입니다. 반환된 단일 버퍼는 CredFree호출하여 해제해야 합니다.

반환 값

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

• ERROR_NOT_FOUND

  명명된 서버에 대한 대상 정보를 사용할 수 없습니다.

발언

요구 사항

참고 항목

credFree

credReadDomainCredentials

CredWriteDomainCredentials

GetLastError