DsAddressToSiteNamesExA 함수(dsgetdc.h)

DsAddressToSiteNamesEx 함수는 지정된 주소에 해당하는 사이트 및 서브넷 이름을 가져옵니다.

구문

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

매개 변수

[in, optional] ComputerName

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

[in] EntryCount

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

[in] SocketAddresses

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

[out] SiteNames

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

[out] SubnetNames

주소와 사이트 이름 매핑을 수행하는 데 사용되는 서브넷 이름이 포함된 null로 끝나는 문자열 포인터 배열을 받습니다. 이 배열의 각 요소는 SocketAddresses 배열의 동일한 요소에 해당합니다. 사이트 이름 매핑에 해당하는 주소가 결정되지 않았거나 사이트 매핑에 해당하는 주소를 수행하는 데 서브넷이 사용되지 않은 경우 요소는 NULL 입니다. 후자는 엔터프라이즈에 매핑된 서브넷 개체가 없는 사이트가 정확히 한 개 있는 경우입니다. 호출자는 NetApiBufferFree를 호출하여 더 이상 필요하지 않은 경우 이 배열을 해제해야 합니다.

반환 값

성공하거나 Win32 또는 RPC 오류가 발생하면 NO_ERROR 반환합니다. 가능한 오류 코드는 다음과 같습니다.

설명

참고

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

요구 사항

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

추가 정보

디렉터리 서비스 함수

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree