AllocADsStr 関数は、 にメモリを割り当て、指定した文字列をコピーします。
構文
LPWSTR AllocADsStr(
[in] LPCWSTR pStr
);
パラメーター
[in] pStr
種類: LPWSTR
コピーする null で終わる Unicode 文字列へのポインター。
戻り値
種類: LPWSTR
成功すると、関数は割り当てられたメモリへの NULL 以外のポインターを返します。 pStr の文字列は、このバッファーにコピーされ、null で終了します。 呼び出し元は、返されたポインターを FreeADsStr に渡すことによって不要になった場合に、このメモリを解放する必要があります。
成功しなかった場合は NULL を 返します。 ADsGetLastError を呼び出して、拡張エラーの状態を取得します。 エラー コード値の詳細については、「 ADSI エラー コード」を参照してください。
注釈
AllocADsStr 関数の使用方法を示す詳細とコード例については、「ReallocADsStr」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | adshlp.h |
| Library | Activeds.lib |
| [DLL] | Activeds.dll |