Metodo IDebugControl3::GetSystemVersion (dbgeng.h)

Articolo
08/07/2023

Il metodo GetSystemVersion restituisce informazioni che identificano il sistema operativo nel computer che esegue la destinazione corrente.

Sintassi

HRESULT GetSystemVersion(
  [out]           PULONG PlatformId,
  [out]           PULONG Major,
  [out]           PULONG Minor,
  [out, optional] PSTR   ServicePackString,
  [in]            ULONG  ServicePackStringSize,
  [out, optional] PULONG ServicePackStringUsed,
  [out]           PULONG ServicePackNumber,
  [out, optional] PSTR   BuildString,
  [in]            ULONG  BuildStringSize,
  [out, optional] PULONG BuildStringUsed
);

Parametri

[out] PlatformId

Riceve l'ID piattaforma. PlatformId è sempre VER_PLATFORM_WIN32_NT per Windows basato su NT.

[out] Major

Riceve 0xF se il sistema operativo di destinazione è una compilazione gratuita o 0xC se il sistema operativo è una compilazione controllata.

[out] Minor

Riceve il numero di build per il sistema operativo della destinazione.

[out, optional] ServicePackString

Riceve la stringa per il livello service pack del computer di destinazione. Se ServicePackString è NULL, queste informazioni non vengono restituite. Se non è installato alcun Service Pack, ServicePackString può essere vuoto.

[in] ServicePackStringSize

Specifica le dimensioni, in caratteri, del buffer specificato da ServicePackString . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] ServicePackStringUsed

Riceve le dimensioni, in caratteri, della stringa del livello del Service Pack. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se ServicePackStringUsed è NULL, queste informazioni non vengono restituite.

[out] ServicePackNumber

Riceve il livello del Service Pack del sistema operativo di destinazione.

[out, optional] BuildString

Riceve la stringa che identifica la compilazione del sistema. Se BuildString è NULL, queste informazioni non vengono restituite.

[in] BuildStringSize

Specifica le dimensioni, in caratteri, del buffer specificato da BuildString . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] BuildStringUsed

Riceve le dimensioni, in caratteri, della stringa che identifica la compilazione. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se BuildStringUsed è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il buffer ServicePackString o il buffer BuildString erano troppo piccoli e la stringa corrispondente è stata troncata.