DsAddressToSiteNamesA 함수(dsgetdc.h)

DsAddressToSiteNames 함수는 지정된 주소에 해당하는 사이트 이름을 가져옵니다.

구문

DSGETDCAPI DWORD DsAddressToSiteNamesA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames
);

매개 변수

[in, optional] ComputerName

이 함수를 처리할 원격 서버의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 도메인 컨트롤러의 이름이어야 합니다. 비 도메인 컨트롤러는 DsGetDcName 을 호출하여 이 함수를 호출하여 도메인 컨트롤러를 찾을 수 있습니다.

[in] EntryCount

SocketAddresses 배열의 요소 수를 포함합니다.

[in] SocketAddresses

변환할 주소를 포함하는 SOCKET_ADDRESS 구조체의 배열을 포함합니다. 이 배열의 각 주소는 AF_INET 형식이어야 합니다. EntryCount 에는 이 배열의 요소 수가 포함됩니다.

[out] SiteNames

주소의 사이트 이름을 포함하는 null로 끝나는 문자열 포인터의 배열을 받습니다. 이 배열의 각 요소는 SocketAddresses 배열의 동일한 요소에 해당합니다. 해당 주소가 알려진 사이트에 매핑되지 않거나 주소 항목이 적절한 양식이 아닌 경우 요소는 NULL 입니다. 호출자는 NetApiBufferFree를 호출하여 더 이상 필요하지 않은 경우 이 배열을 해제해야 합니다.

반환 값

성공하거나 Win32 또는 RPC 오류가 발생하면 NO_ERROR 반환합니다. 다음 목록에는 가능한 오류 코드가 나열되어 있습니다.

설명

참고

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

요구 사항

지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	dsgetdc.h
라이브러리	Netapi32.lib
DLL	Netapi32.dll

추가 정보

디렉터리 서비스 함수

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree