windowsPromoteStringBuffer 函式 (winstring.h)

從指定的HSTRING_BUFFER建立 HSTRING。

語法

HRESULT WindowsPromoteStringBuffer(
  HSTRING_BUFFER bufferHandle,
  HSTRING        *string
);

參數

bufferHandle

類型：[in] HSTRING_BUFFER

要用於新 HSTRING 的緩衝區。 您必須使用 WindowsPreallocateStringBuffer 函 式來建立 HSTRING_BUFFER。

string

類型：[out] HSTRING*

新建立的 HSTRING ，其中包含 bufferHandle 的內容。

傳回值

類型： HRESULT

此函式可以傳回下列其中一個值。

備註

使用 WindowsPromoteStringBuffer 函式，從HSTRING_BUFFER建立新的 HSTRING。 呼叫 WindowsPromoteStringBuffer 函 式會將可變緩衝區轉換為不可變 的 HSTRING。 使用 WindowsPreallocateStringBuffer 函 式來建立 HSTRING_BUFFER。

如果 WindowsPromoteStringBuffer 呼叫失敗，您可以呼叫 WindowsDeleteStringBuffer 函 式來捨棄可變動的緩衝區。

每個 對 WindowsPromoteStringBuffer 函 式的呼叫都必須與 對應的 WindowsDeleteString 呼叫相符。

範例

下列程式代碼範例示範如何使用 WindowsPromoteStringBuffer 函 式。

#include <winstring.h>

int main()
{
    HSTRING hString = NULL;
    HSTRING_BUFFER hStringBuffer = NULL;
    PWSTR strBuffer = NULL;

    HRESULT hr = WindowsPreallocateStringBuffer(10, &strBuffer, &hStringBuffer);

    if (SUCCEEDED(hr))
    {
        // Fill in the buffer

        hr = WindowsPromoteStringBuffer(hStringBuffer, &hString);

        if (SUCCEEDED(hr))
        {
            WindowsDeleteString(hString);
        }
        else
        {
            WindowsDeleteStringBuffer(hStringBuffer);
        }
    }
}

規格需求

另請參閱

HSTRING

HSTRING_BUFFER

WindowsDeleteString

WindowsDeleteStringBuffer

WindowsPreallocateStringBuffer