ISSDataClassification::GetSensitivityClassification

Artikel
05/23/2023

Gilt für: SQL Server Azure SQL-Datenbank Azure Synapse Analytics

Ruft Daten zur Vertraulichkeitsklassifizierung für das aktive Rowset ab. Weitere Informationen und ein Codebeispiel finden Sie unter Verwenden der Datenklassifizierung.

Syntax

HRESULT GetSensitivityClassification(
    SENSITIVITYCLASSIFICATION** ppSensitivityClassification);

Argumente

ppSensitivityClassification[out]
Zeiger auf einen SENSITIVITYCLASSIFICATION-Strukturzeiger. Wenn bei der Methode ein Fehler auftritt oder keine Informationen zur Datenklassifizierung verfügbar sind, weist der Anbieter keinen Arbeitsspeicher zu. Außerdem stellt er sicher, dass das Argument „ppSensitivityClassification“ bei der Ausgabe ein NULL-Zeiger ist.

Rückgabecodewerte

S_OK
Die Methode wurde erfolgreich ausgeführt.

E_INVALIDARG
Das Argument ppSensitivityClassification war NULL.

E_OUTOFMEMORY
Der OLE DB-Treiber für SQL Server konnte nicht genügend Arbeitsspeicher belegen, um die Anforderung abzuschließen.

Bemerkungen

Der OLE DB-Treiber für SQL Server belegt einen Arbeitsspeicherblock für die SENSITIVITYCLASSIFICATION-Struktur und die Daten, auf die diese Struktur verweist. Wenn der Consumer keinen Zugriff mehr auf die Klassifizierungsdaten benötigt, muss er die Zuordnung dieses Arbeitsspeichers durch einen Aufruf der Methode IMalloc::Free aufheben.

Die SENSITIVITYCLASSIFICATION-Struktur wird wie folgt definiert:

typedef struct tagSensitivityClassification
{
    USHORT                     cSensitivityLabels;
    SENSITIVITYLABEL          *rgSensitivityLabels;
    USHORT                     cInformationTypes;
    INFORMATIONTYPE           *rgInformationTypes;
    USHORT                     cColumnSensitivityMetadata;
    COLUMNSENSITIVITYMETADATA *rgColumnSensitivityMetadata;
    SENSITIVITYRANKENUM        eQuerySensitivityRank;
} SENSITIVITYCLASSIFICATION;

Member	Beschreibung
cSensitivityLabels	Die Anzahl von SENSITIVITYLABEL-Strukturen in rgSensitivityLabels.
rgSensitivityLabels	Ein Array aus SENSITIVITYLABEL-Strukturen.
cInformationTypes	Die Anzahl von INFORMATIONTYPE-Strukturen in rgInformationTypes.
rgInformationTypes	Ein Array aus INFORMATIONTYPE-Strukturen.
cColumnSensitivityMetadata	Die Anzahl von COLUMNSENSITIVITYMETADATA-Strukturen in rgColumnSensitivityMetadata.
rgColumnSensitivityMetadata	Ein Array aus COLUMNSENSITIVITYMETADATA-Strukturen.
eQuerySensitivityRank	Eine relative Rangfolge der Vertraulichkeit einer Abfrage, die zum Abrufen des Rowsets ausgeführt wurde.

Die SENSITIVITYLABEL-Struktur wird wie folgt definiert:

typedef struct tagSENSITIVITYLABEL
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} SENSITIVITYLABEL;

Member	Beschreibung
pwszName	Der Name für eine Vertraulichkeitsbezeichnung.
pwszId	Der Bezeichner für eine Vertraulichkeitsbezeichnung.

Die INFORMATIONTYPE-Struktur wird wie folgt definiert:

typedef struct tagINFORMATIONTYPE
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} INFORMATIONTYPE;

Member	Beschreibung
pwszName	Der Name für einen Informationstyp.
pwszId	Der Bezeichner für einen Informationstyp.

Die COLUMNSENSITIVITYMETADATA-Struktur wird wie folgt definiert:

typedef struct tagCOLUMNSENSITIVITYMETADATA
{
    SENSITIVITYPROPERTY* rgSensitivityProperties;
    USHORT cSensitivityProperties;
} COLUMNSENSITIVITYMETADATA;

Member	Beschreibung
cSensitivityProperties	Die Anzahl von SENSITIVITYPROPERTY-Strukturen in rgSensitivityProperties.
rgSensitivityProperties	Ein Array aus SENSITIVITYPROPERTY-Strukturen.

Die SENSITIVITYRANKENUM-Enumeration wird wie folgt definiert:

typedef enum tagSENSITIVITYRANKENUM
{
    SENSITIVITYRANK_NOT_DEFINED = -1,
    SENSITIVITYRANK_NONE = 0,
    SENSITIVITYRANK_LOW = 10,
    SENSITIVITYRANK_MEDIUM = 20,
    SENSITIVITYRANK_HIGH = 30,
    SENSITIVITYRANK_CRITICAL = 40
} SENSITIVITYRANKENUM;

Die SENSITIVITYPROPERTY-Struktur wird wie folgt definiert:

typedef struct tagSENSITIVITYPROPERTY
{
    SENSITIVITYLABEL* pSensitivityLabel;
    INFORMATIONTYPE* pInformationType;
    SENSITIVITYRANKENUM eSensitivityRank;
} SENSITIVITYPROPERTY;

Member	Beschreibung
pSensitivityLabel	Ein Zeiger auf eine SENSITIVITYLABEL-Struktur.
pInformationType	Ein Zeiger auf eine INFORMATIONTYPE-Struktur.
eSensitivityRank	Eine relative Rangfolge der Vertraulichkeit einer Spalte, die Teil von spaltenbasierten Daten ist.

Weitere Informationen

ISSDataClassification
Rowsets

Freigeben über