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 belegten Arbeitsspeicher gespeichert wird. Wenn sie nicht mehr benötigt wird, muss sie mit CoTaskMemFreefreigegeben werden. Dieser Puffer ist immer NULL-terminiert.
-
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. folgende.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt. |
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
[Windows 8 Nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
[Windows Server 2012 Nur Desktop-Apps] |
| Header |
|