Função UtilStringCopyWithAlloc
A função UtilStringCopyWithAlloc aloca e copia uma cadeia de caracteres de origem.
Sintaxe
HRESULT UtilStringCopyWithAlloc(
_Out_ LPWSTR *Buffer,
_In_ UINT BufferMax,
_In_ LPCWSTR Source
);
Parâmetros
-
Buffer [out]
-
Tipo: LPWSTR*
O local em que o ponteiro para a memória alocada é armazenado. Quando não for mais necessário, ele deverá ser lançado com CoTaskMemFree. Esse buffer é sempre encerrado em nulo.
-
BufferMax [in]
-
Tipo: UINT
O número máximo de caracteres a serem lidos da Origem.
-
Origem [in]
-
Tipo: LPCWSTR
A cadeia de caracteres a ser copiada.
Valor retornado
Tipo: HRESULT
Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.
| Código de retorno | Descrição |
|---|---|
|
A operação foi realizada com êxito. |
|
Um ou mais parâmetros não foram fornecidos corretamente. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2012 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|