Funzione GetTimeFormatWrapW

[GetTimeFormatWrapWw è disponibile per l'uso in Windows XP. Potrebbe non essere disponibile nelle versioni successive. È consigliabile usare GetTimeFormatW nel suo posto.

Formatta l'ora come stringa temporale per le impostazioni locali specificate. La funzione formatta un'ora specificata o l'ora del sistema locale.

Nota

GetTimeFormatWrapW è un wrapper per la funzione GetTimeFormatW . Per altre note sull'utilizzo, vedere la pagina GetTimeFormat .

 

Sintassi

int GetTimeFormatWrapW(
  _In_        LCID       Locale,
  _In_        DWORD      dwFlags,
  _In_  const SYSTEMTIME *lpTime,
  _In_        LPCWSTR    pwzFormat,
  _Out_       LPWSTR     pwzTimeStr,
  _In_        int        cchTime
);

Parametri

Impostazioni locali [in]

Tipo: LCID

Specifica le impostazioni locali per le quali la stringa temporale deve essere formattata. Se pwzFormat è NULL, la funzione formatta la stringa in base al formato ora per le impostazioni locali. Se pwzFormat non è NULL, la funzione usa le impostazioni locali solo per informazioni non specificate nella stringa immagine di formato , ad esempio i marcatori di ora delle impostazioni locali.

Questo parametro può essere un identificatore delle impostazioni locali creato dalla macro MAKELCID o uno dei valori predefiniti seguenti.

LOCALE_SYSTEM_DEFAULT

Impostazioni locali di sistema predefinite.

LOCALE_USER_DEFAULT

Impostazioni locali utente predefinite.

dwFlags [in]

Tipo: DWORD

Specifica varie opzioni di funzione. È possibile specificare una combinazione dei valori seguenti.

LOCALE_NOUSEROVERRIDE

Se impostato, la funzione formatta la stringa usando il formato ora predefinito del sistema per le impostazioni locali specificate. In caso contrario, la funzione formatta la stringa usando qualsiasi utente esegue l'override del formato di ora predefinito delle impostazioni locali. Questo flag può essere impostato solo se pwzFormat è NULL.

LOCALE_USE_CP_ACP

Usa la tabella codici ANSI di sistema per la traduzione di stringhe anziché la tabella codici delle impostazioni locali.

TIME_NOMINUTESORSECONDS

Non usa minuti o secondi.

TIME_NOSECONDS

Non usa secondi.

TIME_NOTIMEMARKER

Non usa un marcatore temporale.

TIME_FORCE24HOURFORMAT

Usa sempre un formato di ora 24 ore.

lpTime [in]

Tipo: const SYSTEMTIME*

Puntatore a una struttura SYSTEMTIME contenente le informazioni sul tempo da formattare. Se questo puntatore è NULL, la funzione usa l'ora del sistema locale corrente.

pwzFormat [in]

Tipo: LPCWSTR

Puntatore a un formato da usare per formare la stringa di tempo. Se pwzFormat è NULL, la funzione usa il formato ora delle impostazioni locali specificate. Per altre informazioni, vedere GetTimeFormat .

pwzTimeStr [out]

Tipo: LPWSTR

Puntatore a un buffer che riceve la stringa di tempo formattata.

cchTime [in]

Tipo: int

Dimensioni, in caratteri, del buffer pwzTimeStr . Se cchTime è zero, la funzione restituisce il numero di caratteri necessari per contenere la stringa di tempo formattata e il buffer a cui punta pwzTimeStr non viene usato.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è il numero di caratteri scritti nel buffer a cui punta pwzTimeStr. Se il parametro cchTime è zero, il valore restituito è il numero di caratteri necessari per contenere la stringa di tempo formattata. Il conteggio include il carattere Null terminante.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire uno dei codici di errore seguenti.

ERROR_INSUFFICIENT_BUFFER

ERROR_INVALID_FLAGS

ERROR_INVALID_PARAMETER

Commenti

GetTimeFormatWrapW offre la possibilità di usare stringhe Unicode nei sistemi operativi precedenti a Windows XP. Il metodo preferito consiste nell'usare GetTimeFormatW in combinazione con Microsoft Layer for Unicode (MSLU).

GetTimeFormatWrapW deve essere chiamato direttamente da Shlwapi.dll, usando ordinal 310.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
DLL
Shlwapi.dll (versione 5.0 o successiva)

Vedi anche

GetTimeFormat

 

 

  • Last updated on