Partilhar via


ISSDataClassification::GetSensitivityClassification

Aplica-se a:SQL ServerAzure SQL DatabaseAzure Synapse AnalyticsBase de dados SQL no Microsoft Fabric

Baixar driver OLE DB

Recupera dados de classificação de sensibilidade para o conjunto de linhas ativo. Para mais informações e exemplo de código, consulte Utilização da classificação de dados.

Sintaxe

HRESULT GetSensitivityClassification(
    SENSITIVITYCLASSIFICATION** ppSensitivityClassification);

Arguments

ppClassificaçãoSensibilidade[desligado]
Um apontador para um ponteiro de estrutura SENSITIVITYCLASSIFICATION. Se o método falhar ou não houver informação de classificação de dados disponível, o fornecedor não aloca memória e garante que o argumento ppSensitivityClassification é um ponteiro nulo na saída.

Valores do código de retorno

S_OK
O método teve sucesso.

E_INVALIDARG
O argumento ppSensitivityClassification foi NULL.

E_OUTOFMEMORY
O Driver OLE DB para SQL Server não conseguia alocar memória suficiente para completar o pedido.

Observações

O Driver OLE DB para SQL Server aloca um bloco de memória para armazenar a estrutura SENSITIVITYCLASSIFICATION e os dados referenciados por esta estrutura. Quando o consumidor já não precisa de acesso aos dados de classificação, deve desalocar essa memória chamando o método IMalloc::Free .

A estrutura de classificação da SENSIBILIDADE é definida da seguinte forma:

typedef struct tagSensitivityClassification
{
    USHORT                     cSensitivityLabels;
    SENSITIVITYLABEL          *rgSensitivityLabels;
    USHORT                     cInformationTypes;
    INFORMATIONTYPE           *rgInformationTypes;
    USHORT                     cColumnSensitivityMetadata;
    COLUMNSENSITIVITYMETADATA *rgColumnSensitivityMetadata;
    SENSITIVITYRANKENUM        eQuerySensitivityRank;
} SENSITIVITYCLASSIFICATION;
Membro Description
cEtiquetasSensibilidade O número de estruturas SENSITIVITYLABEL em rgSensitivityLabels.
EtiquetasSensibilidade rg Um conjunto de estruturas SENSITIVITYLABEL.
cInformationTypes O número de estruturas INFORMATIONTYPE em rgInformationTypes.
rgInformationTypes Um conjunto de estruturas INFORMATIONTYPE.
cColumnSensibilityMetadados O número de estruturas COLUMNSENSITIVITYMETADATA em rgColumnSensitivityMetadata.
rgColumnSensitivityMetadados Um conjunto de estruturas de metadados COLUMNSENSITIVITY.
eQuerySensibilityRank Uma classificação relativa da sensibilidade de uma consulta que foi executada para obter o conjunto de linhas.

A estrutura SENSITIVITYLABEL é definida da seguinte forma:

typedef struct tagSENSITIVITYLABEL
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} SENSITIVITYLABEL;
Membro Description
pwszName O nome para uma etiqueta de sensibilidade.
pwszId O identificador de um rótulo de sensibilidade.

A estrutura INFORMATIONTYPE é definida da seguinte forma:

typedef struct tagINFORMATIONTYPE
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} INFORMATIONTYPE;
Membro Description
pwszName O nome para um tipo de informação.
pwszId O identificador para um tipo de informação.

A estrutura de metadados COLUMNSENSITIVITY é definida da seguinte forma:

typedef struct tagCOLUMNSENSITIVITYMETADATA
{
    SENSITIVITYPROPERTY* rgSensitivityProperties;
    USHORT cSensitivityProperties;
} COLUMNSENSITIVITYMETADATA;
Membro Description
cPropriedades de Sensibilidade O número de estruturas SENSITIVITYPROPERTY em rgSensitivityProperties.
rgPropriedades de Sensibilidade Um conjunto de estruturas SENSITIVITYPROPERTY.

O ENUM SENSITIVITYRANKENUM é definido da seguinte forma:

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

A estrutura da propriedade SENSITIVITY é definida da seguinte forma:

typedef struct tagSENSITIVITYPROPERTY
{
    SENSITIVITYLABEL* pSensitivityLabel;
    INFORMATIONTYPE* pInformationType;
    SENSITIVITYRANKENUM eSensitivityRank;
} SENSITIVITYPROPERTY;
Membro Description
pSensibilityLabel Um apontador para uma estrutura SENSITIVITYLABEL.
pInformationType Um apontador para uma estrutura INFORMATIONTYPE.
eSensibilityRank Uma classificação relativa da sensibilidade de uma coluna que faz parte dos dados por coluna.

Ver também

ISSDataClassificação
Conjuntos de linhas