指定した文字列のコピーを作成します。
構文
HRESULT WindowsDuplicateString(
HSTRING string,
HSTRING *newString
);
パラメーター
string
型: [in] HSTRING
コピーする文字列。
newString
型: [out] HSTRING*
文字列のコピー。
戻り値
型: HRESULT
この関数は、これらの値のいずれかを返すことができます。
| リターン コード | Description |
|---|---|
|
HSTRING が正常にコピーされました。 |
|
newString が NULL です。 |
|
新しい HSTRING を割り当てませんでした。 |
注釈
WindowsDuplicateString 関数を使用して HSTRING をコピーします。 WindowsCreateString 関数を呼び出して文字列が作成された場合、バッキング バッファーの参照カウントがインクリメントされます。 WindowsCreateStringReference 関数を呼び出して文字列が作成された場合、Windows ランタイムはソース文字列を新しいバッファーにコピーし、参照カウントを開始します。これは、newString が高速パス文字列ではないことを意味します。
WindowsDuplicateString 関数の各呼び出しは、対応する WindowsDeleteString の呼び出しと一致する必要があります。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | winstring.h |
| Library | mincore.lib |
こちらも参照ください
WindowsCreateStringReference の
WindowsDeleteString の