función Str_GetPtr

[Esta función está disponible a través de Windows XP con Service Pack 2 (SP2) y Windows Server 2003. Es posible que se modifique o no esté disponible en versiones posteriores de Windows.

Copia una cadena de un búfer en otro.

Sintaxis

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

Parámetros

pszSource [in]

Tipo: LPCTSTR

Puntero a una cadena de origen.

pszDest [in, out]

Tipo: LPCSTR

Puntero al búfer de destino. Este valor puede ser NULL.

cchDest [in]

Tipo: int

Tamaño de pszDest, en caracteres.

Valor devuelto

Tipo: int

Si pszDest es NULL o cchDest es cero, devuelve el tamaño del búfer, en caracteres, necesario para contener una copia terminada en null de la cadena a la que apunta pszSource.

Si pszDest no es NULL, devuelve el número de caracteres copiados correctamente, incluido el carácter nulo de terminación.

Si pszDest no puede contener toda la cadena a la que apunta pszSource, se copian los caracteres (cchDest-1), se devuelven la cadena terminada en null y cchDest .

Comentarios

Str_GetPtr está disponible como versiones ANSI (Str_GetPtrA) y Unicode (Str_GetPtrW). Estas funciones no se exportan por nombre ni se declaran en un archivo de encabezado público. Para usarlos, debe usar GetProcAddress y solicitar ordinal 233 (Str_GetPtrA) o 235 (Str_GetPtrW) desde ComCtl32.dll para obtener un puntero de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL	ComCtl32.dll
Nombres Unicode y ANSI	Str_GetPtrW (Unicode) y Str_GetPtrA (ANSI)