Funzione SymSrvStoreSupplementW (dbghelp.h)

Archivia un file nel supplemento specificato in un archivio simboli. Il file è in genere associato a un file nel server dei simboli.

Sintassi

PCWSTR IMAGEAPI SymSrvStoreSupplementW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR Node,
  [in]           PCWSTR File,
  [in]           DWORD  Flags
);

Parametri

[in] hProcess

Handle per un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize.

[in, optional] SymPath

Percorso dell'archivio simboli.

[in] Node

File di simboli associato al file supplementare.

[in] File

Nome del file.

[in] Flags

Se questo parametro è SYMSTOREOPT_COMPRESS, il file viene compresso nell'archivio simboli. Attualmente non sono disponibili altri valori supportati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il percorso completo per il file supplementare.

Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni

Un uso importante per questa funzione consiste nell'archiviare i file differenziali. Per altre informazioni, vedere SymSrvDeltaName.

Questa funzione restituisce un puntatore a un buffer che può essere riutilizzato da un'altra funzione. Assicurarsi quindi di copiare immediatamente i dati restituiti in un altro buffer.

Il server dei simboli archivia i file supplementari con la stessa estensione in una directory comune. Ad esempio, Sup1.xml verrà archiviato nella directory seguente: SymPath\supplement\Node\xml.

L'amministratore di un archivio può impedire agli utenti di scrivere file supplementari creando un file di sola lettura nella radice dell'archivio denominato Supplement. In alternativa, l'amministratore può creare la directory supplementare e usare gli elenchi di controllo di accesso per controllare l'accesso.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione genereranno probabilmente un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Nota

L'intestazione dbghelp.h definisce SymSrvStoreSupplement come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	dbghelp.h
libreria	Dbghelp.lib
dll	Dbghelp.dll
Ridistribuibile	DbgHelp.dll 6.3 o versione successiva

Vedere anche

DbgHelp Functions

SymSrvGetSupplement