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
入力時に、解析する識別名文字列を含む Unicode 文字列ポインターのアドレス。 この文字列の長さは 、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 を含む) |
| Library | Ntdsapi.lib |
| [DLL] | Ntdsapi.dll |