DsGetRdnW 함수(dsparse.h)
DsGetRdnW 함수는 첫 번째 상대 고유 이름의 키와 값을 검색하고 고유 이름 문자열에서 다음 상대 고유 이름에 대한 포인터를 검색합니다.
구문
DSPARSE DWORD DsGetRdnW(
[in, out] LPCWCH *ppDN,
[in, out] DWORD *pcDN,
[out] LPCWCH *ppKey,
[out] DWORD *pcKey,
[out] LPCWCH *ppVal,
[out] DWORD *pcVal
);
매개 변수
[in, out] ppDN
항목에서 구문 분석할 고유 이름 문자열을 포함하는 유니코드 문자열 포인터의 주소입니다. 이 문자열의 길이는 pcDN 매개 변수에 지정됩니다. 함수가 성공하면 이 매개 변수는 현재 상대 고유 이름의 제외된 고유 이름의 나머지 부분을 가리키도록 조정됩니다. 예를 들어 이 매개 변수가 "dc=corp,dc=fabrikam,dc=com" 문자열을 가리키는 경우 함수가 완료된 후 이 매개 변수는 문자열 ",dc=fabrikam,dc=com"을 가리킵니다.
[in, out] pcDN
항목에서 ppDN 문자열의 문자 수를 포함하는 DWORD 값에 대한 포인터입니다. 함수가 성공하면 이 매개 변수는 고유 이름의 나머지 부분에 있는 문자 수를 받습니다. 이러한 값에는 null로 끝나는 문자가 포함되지 않습니다.
[out] ppKey
함수가 성공하면 상대 고유 이름 문자열의 키에 대한 포인터를 수신하는 LPCWCH 값에 대한 포인터입니다. 이 포인터는 ppDN 문자열 내에 있으며 null로 종료되지 않습니다. pcKey 매개 변수는 키의 문자 수를 받습니다. pcKey가 0을 수신하는 경우 이 매개 변수는 정의되지 않습니다.
[out] pcKey
함수가 성공하면 ppKey 매개 변수가 나타내는 키 문자열의 문자 수를 받는 DWORD 값에 대한 포인터입니다. 이 매개 변수가 0을 받으면 ppKey 가 정의되지 않습니다.
[out] ppVal
함수가 성공하면 상대 고유 이름 문자열의 값에 대한 포인터를 수신하는 LPCWCH 값에 대한 포인터입니다. 이 포인터는 ppDN 문자열 내에 있으며 null로 종료되지 않습니다. pcVal 매개 변수는 값의 문자 수를 받습니다. pcVal이 0을 수신하는 경우 이 매개 변수는 정의되지 않습니다.
[out] pcVal
함수가 성공하면 ppVal 매개 변수가 나타내는 값 문자열의 문자 수를 받는 DWORD 값에 대한 포인터입니다. 이 매개 변수가 0을 받으면 ppVal 이 정의되지 않습니다.
반환 값
성공하면 ERROR_SUCCESS 반환하거나 Win32 오류 코드를 반환합니다. 가능한 오류 코드에는 다음 값이 포함됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | dsparse.h(Ntdsapi.h 포함) |
| 라이브러리 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |