funzione Str_GetPtr

[Questa funzione è disponibile tramite Windows XP con Service Pack 2 (SP2) e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Copia una stringa da un buffer a un'altra.

Sintassi

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

Parametri

pszSource [in]

Tipo: LPCTSTR

Puntatore a una stringa di origine.

pszDest [in, out]

Tipo: LPCSTR

Puntatore al buffer di destinazione. Questo valore può essere NULL.

cchDest [in]

Tipo: int

Dimensioni di pszDest, in caratteri.

Valore restituito

Tipo: int

Se pszDest è NULL o cchDest è zero, restituisce le dimensioni del buffer, in caratteri, necessarie per contenere una copia con terminazione null della stringa a cui punta pszSource.

Se pszDest non è NULL, restituisce il numero di caratteri copiati correttamente, incluso il carattere Null terminante.

Se pszDest non può contenere l'intera stringa a cui fa riferimento pszSource, i caratteri (cchDest-1) vengono copiati, la stringa con terminazione null e cchDest restituita.

Commenti

Str_GetPtr è disponibile come versioni ANSI (Str_GetPtrA) e Unicode (Str_GetPtrW). Queste funzioni non vengono esportate per nome o dichiarate in un file di intestazione pubblica. Per usarli, è necessario usare GetProcAddress e richiedere ordinale 233 (Str_GetPtrA) o 235 (Str_GetPtrW) da ComCtl32.dll per ottenere un puntatore a funzione.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
DLL
ComCtl32.dll
Nomi Unicode e ANSI
Str_GetPtrW (Unicode) e Str_GetPtrA (ANSI)