ISSDataClassification::GetSensitivityClassification
Se aplica a: SQL Server Azure SQL Database Azure Synapse Analytics
Recupera los datos de clasificación de confidencialidad del conjunto de filas activo. Para obtener más información y un ejemplo de código, vea Uso de la clasificación de datos.
Sintaxis
HRESULT GetSensitivityClassification(
SENSITIVITYCLASSIFICATION** ppSensitivityClassification);
Argumentos
ppSensitivityClassification[out]
Puntero a un puntero de la estructura SENSITIVITYCLASSIFICATION. Si el método produce un error o no hay información de clasificación de datos disponible, el proveedor no asigna memoria y se asegura de que el argumento ppSensitivityClassification dé como resultado un puntero nulo.
Valores de código de retorno
S_OK
El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
El argumento ppSensitivityClassification era NULL.
E_OUTOFMEMORY
OLE DB Driver for SQL Server no pudo asignar memoria suficiente para completar la solicitud.
Comentarios
El controlador OLE DB Driver for SQL Server asigna un bloque de memoria que contiene la estructura SENSITIVITYCLASSIFICATION y los datos a los que se hace referencia en esta estructura. Cuando el consumidor ya no necesita tener acceso a los datos de clasificación, debe desasignar esta memoria llamando al método IMalloc::Free.
La estructura SENSITIVITYCLASSIFICATION se define de la siguiente manera:
typedef struct tagSensitivityClassification
{
USHORT cSensitivityLabels;
SENSITIVITYLABEL *rgSensitivityLabels;
USHORT cInformationTypes;
INFORMATIONTYPE *rgInformationTypes;
USHORT cColumnSensitivityMetadata;
COLUMNSENSITIVITYMETADATA *rgColumnSensitivityMetadata;
SENSITIVITYRANKENUM eQuerySensitivityRank;
} SENSITIVITYCLASSIFICATION;
Miembro | Descripción |
---|---|
cSensitivityLabels | El número de estructuras SENSITIVITYLABEL en rgSensitivityLabels. |
rgSensitivityLabels | Una matriz de estructuras SENSITIVITYLABEL. |
cInformationTypes | El número de estructuras INFORMATIONTYPE en rgInformationTypes. |
rgInformationTypes | Una matriz de estructuras INFORMATIONTYPE. |
cColumnSensitivityMetadata | El número de estructuras COLUMNSENSITIVITYMETADATA en rgColumnSensitivityMetadata. |
rgColumnSensitivityMetadata | Una matriz de estructuras COLUMNSENSITIVITYMETADATA. |
eQuerySensitivityRank | Una clasificación relativa de la confidencialidad de una consulta que se ejecutó para obtener el conjunto de filas. |
La estructura SENSITIVITYLABEL se define de la siguiente manera:
typedef struct tagSENSITIVITYLABEL
{
LPOLESTR pwszName;
LPOLESTR pwszId;
} SENSITIVITYLABEL;
Miembro | Descripción |
---|---|
pwszName | El nombre de una etiqueta de confidencialidad. |
pwszId | El identificador de una etiqueta de confidencialidad. |
La estructura INFORMATIONTYPE se define de la siguiente manera:
typedef struct tagINFORMATIONTYPE
{
LPOLESTR pwszName;
LPOLESTR pwszId;
} INFORMATIONTYPE;
Miembro | Descripción |
---|---|
pwszName | El nombre de un tipo de información. |
pwszId | El identificador de un tipo de información. |
La estructura COLUMNSENSITIVITYMETADATA se define de la siguiente manera:
typedef struct tagCOLUMNSENSITIVITYMETADATA
{
SENSITIVITYPROPERTY* rgSensitivityProperties;
USHORT cSensitivityProperties;
} COLUMNSENSITIVITYMETADATA;
Miembro | Descripción |
---|---|
cSensitivityProperties | El número de estructuras SENSITIVITYPROPERTY en rgSensitivityProperties. |
rgSensitivityProperties | Una matriz de estructuras SENSITIVITYPROPERTY. |
La enumeración SENSITIVITYRANKENUM se define de la siguiente manera:
typedef enum tagSENSITIVITYRANKENUM
{
SENSITIVITYRANK_NOT_DEFINED = -1,
SENSITIVITYRANK_NONE = 0,
SENSITIVITYRANK_LOW = 10,
SENSITIVITYRANK_MEDIUM = 20,
SENSITIVITYRANK_HIGH = 30,
SENSITIVITYRANK_CRITICAL = 40
} SENSITIVITYRANKENUM;
La estructura SENSITIVITYPROPERTY se define de la siguiente manera:
typedef struct tagSENSITIVITYPROPERTY
{
SENSITIVITYLABEL* pSensitivityLabel;
INFORMATIONTYPE* pInformationType;
SENSITIVITYRANKENUM eSensitivityRank;
} SENSITIVITYPROPERTY;
Miembro | Descripción |
---|---|
pSensitivityLabel | Un puntero a una estructura SENSITIVITYLABEL. |
pInformationType | Un puntero a una estructura INFORMATIONTYPE. |
eSensitivityRank | Una clasificación relativa de la confidencialidad de una columna que forma parte de los datos por columna. |