ignore 屬性

[ignore]屬性會指定結構或等位中包含的指標,而且不會傳輸指標所指示的物件。 [ignore]屬性限制為結構或等位的指標成員。

[ignore] pointer-member-type pointer-name;

參數

pointer-member-type

指定結構或等位的指標成員類型。

pointer-name

指定要在封送處理期間忽略的指標成員名稱。

備註

在目的地上未定義具有 [ignore] 屬性的結構成員值。 遠端電腦上未定義 [in] 參數。 本機電腦上未定義 [out] 參數。

[ignore]屬性可讓您防止傳輸資料。 這在雙連結清單之類的情況下很有用。 下列範例包含引進資料別名的雙連結清單:

/* IDL file */ 
typedef struct _DBL_LINK_NODE_TYPE 
{ 
    long value; 
    struct _DBL_LINK_NODE_TYPE * next; 
    struct _DBL_LINK_NODE_TYPE * previous; 
} DBL_LINK_NODE_TYPE; 
 
HRESULT remote_op([in] DBL_LINK_NODE_TYPE * list_head); 
 
/* application */ 
DBL_LINK_NODE_TYPE * p, * q 
 
p = (DBL_LINK_NODE_TYPE *) midl_user_allocate(
        sizeof(DBL_LINK_NODE_TYPE)); 
q = (DBL_LINK_NODE_TYPE *) midl_user_allocate(
        sizeof(DBL_LINK_NODE_TYPE)); 
 
p->next = q;  
q->previous = p; 
p->previous = q->next = NULL; 
.. 
remote_op(p);

上述範例中發生別名,因為相同的記憶體區域可從 函式 pp-next-previous >>中的兩個不同的指標取得。

請注意 ,[忽略] 無法當做類型屬性使用。

範例

typedef struct _DBL_LINK_NODE_TYPE 
{ 
    long value; 
    struct _DBL_LINK_NODE_TYPE * next; 
    [ignore] struct _DBL_LINK_NODE_TYPE * previous; 
} DBL_LINK_NODE_TYPE;

另請參閱

陣列和Sized-Pointer屬性

陣列

陣列和指標

in

out

ptr

ref

獨特