ISSDataClassification::GetSensitivityClassification

适用于: SQL Server Azure SQL 数据库 Azure Synapse Analytics

下载 OLE DB 驱动程序

检索活动行集的敏感度分类数据。 有关详细信息和代码示例,请参阅使用数据分类

语法

HRESULT GetSensitivityClassification(
    SENSITIVITYCLASSIFICATION** ppSensitivityClassification);

自变量

ppSensitivityClassification[out]
指向 SENSITIVITYCLASSIFICATION 结构指针的指针。 如果方法失败或者不存在可用的数据分类信息,则提供程序不会分配任何内存,并且会确保 ppSensitivityClassification 参数在输出时为一个空指针。

返回代码值

S_OK
方法成功。

E_INVALIDARG
ppSensitivityClassification 参数为 Null。

E_OUTOFMEMORY
OLE DB Driver for SQL Server 无法分配足够的内存来完成请求。

备注

OLE DB Driver for SQL Server 分配内存块来保存 SENSITIVITYCLASSIFICATION 结构和此结构引用的数据。 当使用者不再需要访问分类数据时,使用者必须通过调用 IMalloc::Free 方法释放该内存。

SENSITIVITYCLASSIFICATION 结构的定义如下所示:

typedef struct tagSensitivityClassification
{
    USHORT                     cSensitivityLabels;
    SENSITIVITYLABEL          *rgSensitivityLabels;
    USHORT                     cInformationTypes;
    INFORMATIONTYPE           *rgInformationTypes;
    USHORT                     cColumnSensitivityMetadata;
    COLUMNSENSITIVITYMETADATA *rgColumnSensitivityMetadata;
    SENSITIVITYRANKENUM        eQuerySensitivityRank;
} SENSITIVITYCLASSIFICATION;
成员 描述
cSensitivityLabels rgSensitivityLabels 中的 SENSITIVITYLABEL 结构数。
rgSensitivityLabels SENSITIVITYLABEL 结构的数组。
cInformationTypes rgInformationTypes 中的 INFORMATIONTYPE 结构数。
rgInformationTypes INFORMATIONTYPE 结构的数组。
cColumnSensitivityMetadata rgColumnSensitivityMetadata 中的 COLUMNSENSITIVITYMETADATA 结构数。
rgColumnSensitivityMetadata COLUMNSENSITIVITYMETADATA 结构的数组。
eQuerySensitivityRank 用于获取行集的查询的敏感度的相对排名。

SENSITIVITYLABEL 结构的定义如下所示:

typedef struct tagSENSITIVITYLABEL
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} SENSITIVITYLABEL;
成员 描述
pwszName 敏感度标签的名称。
pwszId 敏感度标签的标识符。

INFORMATIONTYPE 结构的定义如下所示:

typedef struct tagINFORMATIONTYPE
{
    LPOLESTR pwszName;
    LPOLESTR pwszId;
} INFORMATIONTYPE;
成员 描述
pwszName 信息类型的名称。
pwszId 信息类型的标识符。

COLUMNSENSITIVITYMETADATA 结构的定义如下所示:

typedef struct tagCOLUMNSENSITIVITYMETADATA
{
    SENSITIVITYPROPERTY* rgSensitivityProperties;
    USHORT cSensitivityProperties;
} COLUMNSENSITIVITYMETADATA;
成员 描述
cSensitivityProperties rgSensitivityProperties 中的 SENSITIVITYPROPERTY 结构数。
rgSensitivityProperties SENSITIVITYPROPERTY 结构的数组。

SENSITIVITYRANKENUM 枚举定义如下:

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

SENSITIVITYPROPERTY 结构定义如下:

typedef struct tagSENSITIVITYPROPERTY
{
    SENSITIVITYLABEL* pSensitivityLabel;
    INFORMATIONTYPE* pInformationType;
    SENSITIVITYRANKENUM eSensitivityRank;
} SENSITIVITYPROPERTY;
成员 描述
pSensitivityLabel 指向 SENSITIVITYLABEL 结构的指针。
pInformationType 指向 INFORMATIONTYPE 结构的指针。
eSensitivityRank 作为每列数据的一部分的列的敏感度的相对排名。

另请参阅

ISSDataClassification
行集