função Str_GetPtr

  • Artigo

[Essa função está disponível por meio do Windows XP com Service Pack 2 (SP2) e Windows Server 2003. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]

Copia uma cadeia de caracteres de um buffer para outro.

Sintaxe

int WINAPI Str_GetPtr(
  _In_    LPCTSTR pszSource,
  _Inout_ LPCSTR  pszDest,
  _In_    int     cchDest
);

Parâmetros

pszSource [in]

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres de origem.

pszDest [in, out]

Tipo: LPCSTR

Um ponteiro para o buffer de destino. Esse valor pode ser NULL.

cchDest [in]

Tipo: int

O tamanho do pszDest, em caracteres.

Valor retornado

Tipo: int

Se pszDest for NULL ou cchDest for zero, retornará o tamanho do buffer, em caracteres, necessário para conter uma cópia terminada em nulo da cadeia de caracteres apontada por pszSource.

Se pszDest não for NULL, retornará o número de caracteres copiados com êxito, incluindo o caractere nulo de terminação.

Se pszDest não puder manter toda a cadeia de caracteres apontada por pszSource, os caracteres (cchDest-1) serão copiados, a cadeia de caracteres terminada em nulo e cchDest retornado.

Comentários

Str_GetPtr está disponível como versões ANSI (Str_GetPtrA) e Unicode (Str_GetPtrW). Essas funções não são exportadas por nome ou declaradas em um arquivo de cabeçalho público. Para usá-los, você deve usar GetProcAddress e solicitar ordinal 233 (Str_GetPtrA) ou 235 (Str_GetPtrW) de ComCtl32.dll para obter um ponteiro de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
DLL
ComCtl32.dll
Nomes Unicode e ANSI
 Str_GetPtrW (Unicode) e Str_GetPtrA (ANSI)