Export (0) Print
Expand All

3.1.4.15 NspiModLinkAtt (Opnum 14)

The NspiModLinkAtt method modifies the values of a specific property of a specific row in the address book.

long NspiModLinkAtt(
  [in] NSPI_HANDLE hRpc,
  [in] DWORD dwFlags,
  [in] DWORD ulPropTag,
  [in] DWORD dwMId,
  [in] BinaryArray_r* lpEntryIds
);

hRpc: An RPC context handle as specified in section 2.3.9.

dwFlags: A DWORD value containing a set of bit flags. The server MUST ignore values other than the bit flag fDelete.

ulPropTag: A DWORD value. Contains the proptag of the property that the client wishes to modify.

dwMId: A DWORD value containing the MId of the address book row that the client wishes to modify.

lpEntryIds: A BinaryArray value. Contains a list of Entry IDs to be used to modify the requested property on the requested address book row. These Entry IDs can be either Ephemeral Entry IDs or Permanent Entry IDs or both.

Return Values: The server returns a long value specifying the return status of the method.

No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].

Upon receiving this message, the server MUST process the data from the message subject to the following constraints:

  1. If the server returns any return value other than Success, the server MUST NOT modify any properties of any objects in the address book.

  2. The server MAY<30> make additional validations as described in Security (section 5). If the server chooses to limit the visibility of data based on these validations, the server MUST proceed as if that data did not exist in the address book.

  3. If the input parameter ulPropTag does not specify a proptag the server recognizes, the server MUST return NotFound.

  4. If the server is unable to locate the object specified by the input parameter dwMId, the server MUST return the value InvalidParameter.

  5. If the server is able to locate the object, but will not allow modifications to the object due to its display type, the server MUST NOT modify any properties of any objects in the address book, and the server MUST return the value Success.

  6. If the input parameter dwFlags contains the bit value fDelete, the server MUST remove all values specified by the input parameter lpEntryIDs from the property specified by ulPropTag for the object specified by input parameter dwMId. The server MUST ignore any values specified by lpEntryIDs that are not present on the object specified by dwMId.

  7. If the input parameter dwFlags does not contain the bit value fDelete, the server MUST add all values specified by the input parameter lpEntryIDs to the property specified by ulPropTag for the object specified by the input parameter dwMId. The server MUST ignore any values specified by lpEntryIDs that are already present on the object specified by dwMId.

  8. If the server is unable to apply the modifications specified, the server MUST return the value AccessDenied.

  9. If no other return values have been specified by these constraints, the server MUST return the return value Success.

 
Show:
© 2014 Microsoft