UtilLoadStringWithAlloc-Funktion

Die UtilLoadStringWithAlloc-Funktion weist eine Zeichenfolge aus der Ressourcentabelle zu und lädt sie.

Syntax

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

Die Parameter

uID [in]

Typ: UINT-

Bezeichner der zu ladenden Zeichenfolge.

ppwzBuffer [out]

Typ: LPWSTR*

Der Speicherort, an dem die neu zugewiesene Zeichenfolge platziert wird. Die Zeichenfolge muss mit CoTaskMemFree freigegeben werden, wenn sie nicht mehr benötigt wird.

cchBufferMax [in]

Typ: UINT-

Die maximale Anzahl von Zeichen, die aus der Ressourcentabelle geladen werden sollen. Wenn die Ressourcenzeichenfolge länger als die angegebene Anzahl von Zeichen ist, wird sie abgeschnitten und null beendet.

Hinweis

Dieser Parameter ist möglicherweise nicht auf Null festgelegt.

Rückgabewert

Typ: HRESULT-

Mögliche Rückgabewerte sind, aber nicht beschränkt auf Folgendes.

Anforderungen

Siehe auch

UtilStringCopyWithAlloc-

UtilAssembleStringsWithAlloc

CoTaskMemFree-