LoadString
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função carrega um recurso seqüência de caracteres a partir de associado arquivo executável com um módulo especificado, copia o seqüência de caracteres em uma reserva e acrescenta um caractere nulo de terminação.
Syntax
int LoadString(
HINSTANCE hInstance,
UINT uID,
LPTSTR lpBuffer,
int cchBufferMax
);
Parameters
- hInstance
[no] Identificador para uma instância do módulo cujo arquivo executável contém o recurso seqüência de caracteres.
- uID
[no] Identificador inteiro do seqüência de caracteres para ser carregado.
- lpBuffer
[out] Ponteiro longo para a reserva para receber o seqüência de caracteres.
- cchBufferMax
[no] Tamanho da reserva em caracteres. O seqüência de caracteres é truncado e NULL terminada se ele for maior do que o número de caracteres especificados.
Return Value
O número de caracteres copiados para a reserva, excluindo o caractere nulo de terminação, indica sucesso. Zero indica que o recurso seqüência de caracteres não existe. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Se lpBuffer é definido como NULL, o valor de retorno é um ponteiro para o seqüência de caracteres solicitada. O chamador deve CAST o valor de retorno para um LPCTSTR. Esse ponteiro aponta diretamente para o recurso, portanto, o seqüência de caracteres é somente leitura. O comprimento do seqüência de caracteres, não incluindo qualquer caractere nulo de terminação, pode ser encontrado na palavra acima de seqüência de caracteres.
Para usar o lpBuffer ponteiro, a –n sinalizador deve ser definida com o compilador recurso, RC.
Observação
Recursos de seqüência de caracteres não são Por padrão NULL-Terminated.Quando lpBuffer é definido como NULL, verificar se o recurso seqüência de caracteres representado pelo ponteiro retornado por LoadString é terminação nula e se necessário, anexar uma caractere nulo de terminação para o recurso antes de usá-lo em seu aplicativo.
Requirements
| Header | winbase.h |
| Library | Loadstr.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |