ISSDataClassification::GetSensitivityClassification

Se aplica a: SQL ServerAzure SQL DatabaseAzure 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