Funzione MsiDatabaseGetPrimaryKeysA (msiquery.h)

Articolo
11/20/2024

La funzione msiDatabaseGetPrimaryKeys restituisce un record contenente i nomi di tutte le colonne chiave primaria per una tabella specificata. Questa funzione restituisce un handle che deve essere chiuso usando MsiCloseHandle.

Sintassi

UINT MsiDatabaseGetPrimaryKeysA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szTableName,
  [out] MSIHANDLE *phRecord
);

Parametri

[in] hDatabase

Handle per il database. Vedere ottenere un handle di database.

[in] szTableName

Specifica il nome della tabella da cui ottenere i nomi delle chiavi primarie.

[out] phRecord

Puntatore all'handle del record che contiene i nomi delle chiavi primarie.

Valore restituito

Questa funzione restituisce UINT.

Osservazioni

Il conteggio dei campi del record restituito è il conteggio delle colonne chiave primaria restituite dalla funzione MsiDatabaseGetPrimaryKeys. Il record restituito contiene il nome della tabella in Field (0) e i nomi di colonna che costituiscono i nomi delle chiavi primarie nei campi che hanno esito positivo. Questi nomi di chiave primaria corrispondono ai numeri di colonna per i campi.

Questa funzione non può essere usata con la tabella _Tables o con la tabella _Columns.

Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE quando escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere usare PMSIHANDLE anziché la sezione HANDLE nella Procedure consigliate di Windows Installer.

Nota

L'intestazione msiquery.h definisce MsiDatabaseGetPrimaryKeys 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
client minimo supportato	Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP
piattaforma di destinazione	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni generali di accesso al database

Condividi tramite