Compartir a través de


ISSDataClassification::GetSensitivityClassification

Se aplica a: SQL Server Azure SQL Database Azure Synapse Analytics

Descargar controlador OLE DB

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.

Consulte también

ISSDataClassification
Conjuntos de filas