_makepath_s, _wmakepath_s

Articolo
06/09/2015

Crea un nome di percorso da componenti. Queste sono versioni di _makepath, _wmakepath con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

errno_t _makepath_s(
   char *path,
   size_t sizeInBytes,
   const char *drive,
   const char *dir,
   const char *fname,
   const char *ext 
);
errno_t _wmakepath_s(
   wchar_t *path,
   size_t sizeInWords,
   const wchar_t *drive,
   const wchar_t *dir,
   const wchar_t *fname,
   const wchar_t *ext 
);
template <size_t size>
errno_t _makepath_s(
   char (&path)[size],
   const char *drive,
   const char *dir,
   const char *fname,
   const char *ext 
); // C++ only
template <size_t size>
errno_t _wmakepath_s(
   wchar_t (&path)[size],
   const wchar_t *drive,
   const wchar_t *dir,
   const wchar_t *fname,
   const wchar_t *ext 
); // C++ only

Parametri

[out] path
Buffer del percorso completo.
[in] sizeInWords
Dimensione del buffer in parole.
[in] sizeInBytes
Dimensione, in byte, del buffer.
[in] drive
Contiene una lettera (A, B e così via) corrispondente all'unità desiderata ed i due punti finali opzionali. _makepath_s inserisce i due punti automaticamente nel percorso composto se mancante. Se drive è NULL o punta ad una stringa vuota, nessuna lettera di unità viene visualizzata nella stringa composta di path.
[in] dir
Contiene il percorso delle directory, escluso il designatore di unità o del nome del file effettivo. La barra finale è facoltativa e sia una barra (/) o una barra rovesciata (\) o entrambe possono essere utilizzate in un unico argomento dir. Se nessuna barra finale (/o \) viene specificata, viene inserita automaticamente. Se dir è NULL o punta a una stringa vuota, nessun percorso di directory viene inserito nella stringa composta di path.
[in] fname
Contiene il nome del file di base senza alcuna estensione di file. Se fname è NULL o punta a una stringa vuota, nessun nome file viene inserito nella stringa composta di path.
[in] ext
Contiene in l'estensione attuale del file, con o senza un punto iniziale (.). _makepath_s inserisce il periodo automaticamente se non viene visualizzato in ext. Se ext è NULL o punta a una stringa vuota, nessuna estensione viene inserita nella stringa composta di path.

Valore restituito

Zero se ha esito positivo; un codice di errore in caso di errore.

Condizioni di errore

path	sizeInWords / sizeInBytes	Restituzione	Contenuto di path.
NULL	any	EINVAL	non modificato
any	<= 0	EINVAL	non modificato

Se una delle condizioni di errore sopra si verifica, queste funzioni richiamano il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può proseguire, errno è impostato su EINVAL e la funzione restituisce EINVAL**.** NULL è consentito per i parametri drive, fname e ext. Per informazioni sul comportamento quando questi parametri sono puntatori null o stringhe vuote, vedere la sezione relativa alle Osservazioni.

Note

La funzione _makepath_s crea una stringa di percorso composta da singoli componenti, archivia il risultato in path. path potrebbe includere una lettera di unità, un percorso di directory, un nome di file ed un'estensione del nome file. _wmakepath_s è una versione a caratteri "wide" di _makepath_s. Gli argomenti per _wmakepath_s sono stringhe a caratteri "wide". _wmakepath_s e _makepath_s si comportano in modo identico in caso contrario.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_tmakepath_s	_makepath_s	_makepath_s	_wmakepath_s

L'argomento path deve puntare ad un buffer vuoto abbastanza grande da contenere il percorso completo. Il path composto non deve essere maggiore della costante _MAX_PATH, definita in Stdlib.h.

Se path è NULL, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Inoltre, errno è impostato su EINVAL. I valori NULL sono consentiti per tutti gli altri parametri.

In C++ l'utilizzo di queste funzioni è semplificato dagli overload dei modelli. Gli overload possono dedurre la lunghezza del buffer automaticamente (eliminando la necessità di specificare un argomento di dimensione) e possono sostituire automaticamente le funzioni precedenti e non sicure con le controparti più recenti e sicure. Per ulteriori informazioni, vedere Overload di modelli sicuri.

La versione di debug di queste funzioni per prima cosa riempiono il buffer con il valore 0xFD. Per disattivare questo comportamento, utilizzare _CrtSetDebugFillThreshold.

Requisiti

Routine	Intestazione obbligatoria
_makepath_s	<stdlib.h>
_wmakepath_s	<stdlib.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

// crt_makepath_s.c

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char path_buffer[_MAX_PATH];
   char drive[_MAX_DRIVE];
   char dir[_MAX_DIR];
   char fname[_MAX_FNAME];
   char ext[_MAX_EXT];
   errno_t err;

   err = _makepath_s( path_buffer, _MAX_PATH, "c", "\\sample\\crt\\",
                      "crt_makepath_s", "c" );
   if (err != 0)
   {
      printf("Error creating path. Error code %d.\n", err);
      exit(1);
   }
   printf( "Path created with _makepath_s: %s\n\n", path_buffer );
   err = _splitpath_s( path_buffer, drive, _MAX_DRIVE, dir, _MAX_DIR, fname,
                       _MAX_FNAME, ext, _MAX_EXT );
   if (err != 0)
   {
      printf("Error splitting the path. Error code %d.\n", err);
      exit(1);
   }
   printf( "Path extracted with _splitpath_s:\n" );
   printf( "  Drive: %s\n", drive );
   printf( "  Dir: %s\n", dir );
   printf( "  Filename: %s\n", fname );
   printf( "  Ext: %s\n", ext );
}

Output

Path created with _makepath_s: c:\sample\crt\crt_makepath_s.c

Path extracted with _splitpath_s:
  Drive: c:
  Dir: \sample\crt\
  Filename: crt_makepath_s
  Ext: .c