UtilStringCopyWithAlloc-Funktion
Die UtilStringCopyWithAlloc-Funktion ordnet eine Quellzeichenfolge zu und kopiert sie.
Syntax
HRESULT UtilStringCopyWithAlloc(
_Out_ LPWSTR *Buffer,
_In_ UINT BufferMax,
_In_ LPCWSTR Source
);
Parameter
-
Puffer [out]
-
Typ: LPWSTR*
Der Speicherort, an dem der Zeiger auf den zugeordneten Arbeitsspeicher gespeichert wird. Wenn es nicht mehr benötigt wird, muss es mit CoTaskMemFree freigegeben werden. Dieser Puffer ist immer NULL-endend.
-
BufferMax [in]
-
Typ: UINT
Die maximale Anzahl von Zeichen, die aus der Quelle gelesen werden sollen.
-
Quelle [in]
-
Typ: LPCWSTR
Die zu kopierende Zeichenfolge.
Rückgabewert
Typ: HRESULT
Mögliche Rückgabewerte sind u. a. die folgenden:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 [nur Desktop-Apps] |
| Header |
|