AllocADsStr 関数 (adshlp.h)

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

こちらもご覧ください

ADSI 関数

ADsGetLastError

FreeADsStr

ReallocADsStr