DsCrackUnquotedMangledRdnA 関数 (dsparse.h)
DsCrackUnquotedMangledRdn 関数は、指定された相対識別名をアンマングル (unencodes) し、デコードされた GUID と使用されるマングリング型の両方を返します。
構文
DSPARSE BOOL DsCrackUnquotedMangledRdnA(
[in] LPCSTR pszRDN,
[in] DWORD cchRDN,
[out, optional] GUID *pGuid,
[out, optional] DS_MANGLE_FOR *peDsMangleFor
);
パラメーター
[in] pszRDN
変換する相対識別名 (RDN) を含む文字列へのポインター。 この文字列の長さは cchRDN パラメーターで指定されるため、この文字列は null で終わる必要はありません。 この文字列は、引用符で囲まれていない形式である必要があります。 引用符で囲まれていない相対識別名の詳細については、「 DsUnquoteRdnValue」を参照してください。
[in] cchRDN
pszRDN 文字列の長さを文字数で表します。
[out, optional] pGuid
管理されていない相対識別名の GUID を受け取る GUID 値への ポインター。 このパラメーターは、NULL でもかまいません。
[out, optional] peDsMangleFor
マングルされた相対識別名で使用されるマングリングの種類を受け取る DS_MANGLE_FOR値への ポインター。 このパラメーターは、NULL でもかまいません。
戻り値
この関数は、相対識別名が壊れている場合は TRUE 、それ以外の場合は FALSE を 返します。 この関数が FALSE を返す場合、 pGuid または peDsMangleFor はデータを受信しません。
注釈
この関数は、削除または名前付けの競合が原因で以前に管理されていた RDN をデコード (アンマングル) しようとします。 相対識別名が壊れている場合、関数は TRUE を 返し、要求された場合は GUID とマングル型を取得します。 相対識別名がマングルされていない場合、関数は FALSE を返します。
注意
dsparse.h ヘッダーは、DSCrackUnquotedMangledRdn をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | dsparse.h (Ntdsapi.h を含む) |
| Library | Ntdsapi.lib |
| [DLL] | Ntdsapi.dll |